home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / sqwnt272.zip / SQWINT.DOC next >
Text File  |  1990-02-11  |  8KB  |  193 lines
  1. SQWINT....copyright, 1990, by Jeffrey E. Salzberg
  2.  
  3.  
  4. SQWINT is a file-listing program written specifically for computer users
  5. who are visually impaired and using speech-synthesis hardware and
  6. software (although sighted users are certainly welcome, too).
  7.  
  8. SYNTAX:
  9.  
  10.    From the command line (the "C:" or "A:") prompt, type:
  11.  
  12.                 sqwint [-options] [filename] [/text editor pathname]
  13.  
  14.  
  15.    The options are...well...optional.  If you do not type a filename,
  16.    the program will prompt you for one.  At this point, you may invoke the
  17.    same options (using the same syntax) as from the command line.  If
  18.    you answer the filename prompt with a "?" (by itself), SQUINT shells to
  19.    DOS.  This enables you, for example, to use a directory listing
  20.    program (I recommend Scott Stanton's SDIR as one that works quite
  21.    well with speech).  SQWINT does accept the "*" and "?" wildcard
  22.    characters.
  23.  
  24.  
  25.    Valid options are:
  26.  
  27.         1   selects LPT1 as the printer port (this is the default).
  28.  
  29.         2   selects LPT2 as the printer port.
  30.  
  31.         3   selects COM1 as the printer port.
  32.  
  33.         4   selects COM2 as the printer port.
  34.  
  35.         b   tells SQWINT to beep at the end of each screen page.
  36.  
  37.         d   turns on the Direct-screen-write mode - NOT a feature which
  38.             will be useful to most blind users.
  39.  
  40.         f   turns off the control-character Filter, which prevents
  41.             control-characters from being displayed.
  42.  
  43.         h   displays this Help file - "SQWINT.DOC".
  44.  
  45.         l   causes SQWINT to wait for a keypress after displaying each
  46.             line.  If the key pressed is "l", SQUINT leaves Line-by-line
  47.             mode.
  48.  
  49.         n   cause SQUINT to display the file Non-stop.  This can be
  50.             changed while the file is being displayed (see below).
  51.  
  52.         p   causes SQWINT to Print the file directly to the printer
  53.             instead of the screen and synthesizer.
  54.  
  55.         r   prevents SQWINT from displaying an ANSI graphics character
  56.             indicating the presence of a hard carriage Return.
  57.  
  58.         t   turns off the control-character Trading.  When this option
  59.             is on (and the control-character filter is off), control
  60.             characters are printed as inverse letters rather than as
  61.             ANSI graphics characters.
  62.  
  63.    The option string must be preceded by a minus sign.  The editor
  64.    pathname must be preceded by a forward slash.
  65.  
  66.  
  67.    Certain commands can be invoked while SQWINT is in the "More" and
  68.    "End Of File" modes.  These are:
  69.  
  70.         ?                   Echoes the list of available commands to the speech
  71.                             synthesizer.  Sighted users will see no effect from
  72.                             this command other than a cursor moving rapidly
  73.                             across the top line of the screen and a delay of
  74.                             approximately 3 seconds.
  75.  
  76.         <                   performs a backward search for a designated
  77.                             string.  Searches may be case-sensitive or
  78.                             not, at the user's option.  When SQWINT
  79.                             finds a match, the computer beeps and
  80.                             the new page is displayed, but only the lines
  81.                             containing the search string are echoed by the
  82.                             synthesizer.  Sighted users will see these
  83.                             lines in inverse video.  To hear the entire
  84.                             page, press "S" at the "More" prompt (see
  85.                             below).
  86.  
  87.         >                   performs a forward search, as above.
  88.  
  89.         1-9                 pressing a number key  will move you proportionately
  90.                             through the file.  This may entail a short wait
  91.                             while SQWINT finds the end of the file and tabulates
  92.                             the starting location of each page.  This wait will
  93.                             only be incurred once.
  94.  
  95.         b                   toggles the end-of-page Beeps.
  96.  
  97.         c                   turns on "Capture" mode (see below.
  98.  
  99.         d                   toggles the Direct-screen-write mode.
  100.  
  101.         e                   shells to the text Editor of your choice.
  102.                             If no editor has been specified from the
  103.                             command line, SQWINT will prompt for one.
  104.  
  105.         f                   toggles the control-character Filter.
  106.  
  107.         h                   displays this Help file.
  108.  
  109.         i                   causes SQWINT to speak the following
  110.                             Information about the file being viewed:
  111.  
  112.                                file length
  113.                                the user's position in the file
  114.                                page number
  115.  
  116.         l                   toggles the Line-by-line mode.
  117.  
  118.         n                   toggles the Non-stop mode.
  119.  
  120.         p                   Prints the file to the selected printer port.
  121.  
  122.         r                   toggles the hard-Return display.
  123.  
  124.         s                   re-lists the current Screen.
  125.  
  126.         t                   toggles control-character Trading.
  127.  
  128.         Control - PageUp    displays the first page of the file.
  129.  
  130.         Control -PageDown   displays the last page of the file.  This
  131.                             may entail a short wait.
  132.  
  133.         End                 moves the cursor to the last line of the
  134.                             page.
  135.  
  136.         Home                moves the cursor to the top line of the
  137.                             page.
  138.  
  139.         PageUp              moves the file backward one page.
  140.  
  141.         Cursor Arrows       move the cursor up and down or right and left.
  142.  
  143.         Escape              terminates the program.
  144.  
  145.         Any other keypress will advance the file one page in the "More"
  146.         mode or will prompt you for a new file if in the "End-Of-File"
  147.         mode.
  148.  
  149.  
  150.    While SQWINT is displaying a line, the following keys may be used:
  151.  
  152.         l                   toggles the Line-by-line mode.
  153.  
  154.         n                   toggles the Non-stop mode.
  155.  
  156.         Escape              terminates program (in help mode, this key
  157.                             restores the file being listed instead of
  158.                             terminating the program.)
  159.  
  160.    While SQWINT is in "Capture" mode, the following keys may be used:
  161.  
  162.         up and
  163.         down arrows         expand the capture buffer by one line.
  164.  
  165.         home                starts the capture buffer at the first line
  166.                             of the display window.
  167.  
  168.         end                 ends the capture buffer on the last line of
  169.                             the display window.
  170.  
  171.         p                   Prints the capture buffer to the selected
  172.                             printer and returns SQWINT to the "More" or
  173.                             "End of File mode.
  174.  
  175.         s                   Saves the capture buffer to a disk file.
  176.                             SQWINT will prompt for a file name (the
  177.                             default is "SQWINT.CAP").  SQWINT then
  178.                             returns to the "More" or "End of File" mode.
  179.  
  180.  
  181.  
  182.    If you find SQWINT to be of value, please send $10 (or whatever you
  183.    think the program is worth) to:
  184.  
  185.                             Jeffrey E. Salzberg
  186.                             3002 Purdue #3
  187.                             Houston, TX 77005
  188.  
  189.                             (713) 660-7110
  190.  
  191.    Comments, suggestions, and <shudder> even bug reports are always
  192.    welcome, whether you have registered SQWINT or not.
  193.